Elemento da Aula

  1. Introdução ao RStudio;
  2. Instalação de Pacotes;
  3. Leitura de arquivos de Ajuda;
  4. Algumas dicas iniciais do RStudio.

Introdução ao RStudio

  • O RStudio é uma interface usada para facilitar a sua vida ao utilizar a linguagem R.
  • Ele não é o R em si!
  • Outras opções existem, como o Tinn-R e o Microsoft R.
  • A interface gráfica básica do RStudio.

O Console

  • É a janela de execução do R, similar a abrir somente o programa base do R.
  • Nesta área você encontra:
    1. O console do R;
    2. A versão do R que está sendo executada;
    3. O diretório de trabalho da sessão.

O Projeto

  • Podemos organizar todo o trabalho que estamos fazendo ao redor de um projeto.
  • Um projeto vai conter todos os arquivos, scripts e figuras necessários para realizarmos uma tarefa (manuscrito, dissertação, tese, análise,…).
  • Existem muitas vantagens em se iniciar um projeto para cada tarefa que estamos fazendo - uma delas é que o diretório utilizado para carregar r salvar arquivos fica sendo consistente entre qualquer computador em que você abrir o projeto.

O Script

  • É sempre bom escrevermos o código que queremos usar em uma tarefa em um script e, a partir dele, enviar os comandos para o console.
  • Um script pode conter o código e anotações utilizadas para gerar qualquer tipo de computação.
  • Sempre use um script para manter o registro de tudo o que você está fazendo ao realizar uma tarefa.
  • Nesta área você encontra:
    1. A janela do script;
    2. O botão Run, usado para enviar o comando do script ao console;
    3. Um botão para salvar o script em um diretório de sua escolha (ou salvar as alterações feitas nele);
    4. Um botão de busca e/ou substituição;
    5. Uma aba para facilitar a navegação entre as partes (“capítulos”) do seu script.

Informações relacionadas à sessão

  • Todas informações relacionadas aos arquivos e objetos existentes em uma sessão (1, aba “Environment”) e todo o histórico de comandos executados (2, aba “History”) são encontrados aqui.
  • Na aba “Environment”, você encontra utilidades como:
    1. Um botão para excluir todos os arquivos e objetos carregados/criados;
    2. Um botão para importar tabelas para o ambiente (“Import Dataset”; uso não recomendado).

Outras funcionalidades presentes do RStudio

  • Aqui estão concentradas algumas funcionalidades importantes do RStudio e do R.
    1. Aba “Files”
      1. Contém todos os arquivos em um diretório;
      2. O “..” na primeira linha pode ser utilizado para mover ao diretório acima do que você observa;
    2. Ainda na aba “Files”, existem botões que você pode usar para:
      1. Criar uma nova pasta em um diretório (“New folder”);
      2. Deletar um arquivo ou pasta (“Delete”);
      3. Renomear um arquivo ou pasta (“Rename”).
    3. Toda vez que você criar um gráfico ou figura, ele será apresentado na aba “Plots”; você pode salvar esta figura diretamente a partir da aba, mas isso não é muito recomendado (veremos isso nas aulas de base::plot e ggplot2);
    4. A partir da aba “Packages” você pode instalar, fazer o update, carregar e/ou acessar o conteúdo de um pacote.
    5. Todo e qualquer arquivo de ajuda de uma função ou pacote é apresentado e descrito na aba “Help”.

Instalação de Pacotes

  • Um pacote do R contém um conjunto de funções que auxiliam na execução de determinadas tarefas (carregamento de dados, criação de gráficos, análises estatísticas e etc).
  • Um exemplo de função é o install.packages, utilizado para instalar novos pacotes ao seu R.
  • Uma função pode levar inúmeros argumentos.
  • Um argumento são valores ou opções necessárias para a execução de uma função.
args(install.packages)
## function (pkgs, lib, repos = getOption("repos"), contriburl = contrib.url(repos, 
##     type), method, available = NULL, destdir = NULL, dependencies = NA, 
##     type = getOption("pkgType"), configure.args = getOption("configure.args"), 
##     configure.vars = getOption("configure.vars"), clean = FALSE, 
##     Ncpus = getOption("Ncpus", 1L), verbose = getOption("verbose"), 
##     libs_only = FALSE, INSTALL_opts, quiet = FALSE, keep_outputs = FALSE, 
##     ...) 
## NULL
  • Vamos instalar um pacote para exemplificar o uso da função install.packages:
install.packages(pkgs = "taxize", dependencies = TRUE)

Leitura de arquivos de Ajuda

  • Para pedir ajuda sobre uma função você pode usar:
    1. Método específico para funções:
      • ?nome_da_funcao;
      • help(topic = "nome_da_funcao", package = "nome_do_pacote_em_que_esta_a_funcao");
    2. Método específico para pacotes:
      • help(package = "nome_do_pacote_em_que_esta_a_funcao");
    3. Ajuda de forma generalizada sobre um pacote ou função:
      • ??nome_do_pacote_ou_funcao;
      • O pacote sos tem um método de busca bem legal também.
  • Todo arquivo de ajuda de uma função é separado em:
    1. Nome da função e pacote no qual ela está localizada;
    2. Título da função;
    3. Descrição geral da função
    4. Forma de uso da função, contendo a sua chamada e todos os argumentos existentes nelas;
    5. Descrição detalhada de todos os argumentos usados pela função;
    1. Descrição do funcionamento geral da função, consequências do uso de um ou outro tipo de opção no uso dos argumentos, discussão geral sobre a teoria por trás de cada argumento e etc;
    1. Notas gerais sobre o funcionamento da função;
    2. Sugestões de outras funções correlatas;
    3. Exemplo prático do uso da função.
  • Assim como qualquer outra língua, você precisa saber o básico dela para entender o que está escrito.

Algumas dicas iniciais do RStudio

  1. Use sempre um projeto para organizar os seus scripts;
  2. Organize seu script em “capítulos” - para isso, utilize o atalho do teclado: Command + Shift + r no MAC ou Control + Shift + r no Windows;
  3. Adicione comentários ao seu script sempre que puder, através do #.
  4. Ao invés de ficar pressionando o botão Run para enviar os comandos do script para o console, utilize Command + Enter no MAC ou Control + Enter no Windows;
  5. Para ver os últimos comandos lançados no console, coloque o cursor lá e utilize Command + Seta para cima no MAC ou Control + Seta para cima no Windows;
  6. Na dúvida sobre uma função? Coloque o curso em cima dela (no console ou no script) e pressione Function + F1 no MAC ou F1 no Windows;
  7. Use a ferramenta de auto-completar do RStudio: comece a escrever o nome da função que você deseja, aperte Tab e navegue pelas opções através das setas.
  8. Na dúvida também sobre os argumentos que existem em uma função? Dentro do parenteses que descreve seus argumentos, pressione Tab, navegue pela lista de argumentos e veja uma pequena descrição do que cada um deles deve ser.
  9. Quer apagar tudo que está escrito no seu console? Use Control + L no MAC ou no Windows.

Exercício

  1. Instale os pacotes readr e readxl, além de todas as suas dependencias.